home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / fmsarc13.zip / FMSARC.DOC next >
Text File  |  1990-05-07  |  7KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                     FMSARC - The FMS Archive Indicator Fixer
  17.  
  18.                                   Version 1.30
  19.  
  20.                          Copyright 1989 by Michael Walsh
  21.  
  22.                              Walsh MicroSystems BBS
  23.                                 Philadelphia, PA
  24.                                  (215) 677-2966
  25.                                  24 hours a day
  26.                                1200/2400/9600 HST
  27.  
  28.                               Compuserve 76675,1476
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         FMSARC V1.30 Copyright 1990 by Michael Walsh          Page 2
  68.  
  69.  
  70.         INTRODUCTION
  71.         -----------------------------------------------------------------
  72.  
  73.         FMSARC  was conceived after I realized that my disk was too small
  74.         for  the  files  I was  receiving.   After  a  while,  it  became
  75.         necessary  for me to start to back files up and delete them  from
  76.         the drive in order to make room.
  77.  
  78.         What  FMSARC  does is set an indicator in the FMS  directory  for
  79.         files that are in the directory but not on the disk.  At position
  80.         33 in each line of an FMS directory is a space;  this position is
  81.         otherwise unused.   Files that are found in the directory but not
  82.         on  disk  are flagged with an asterisk (*) in  that  space.   The
  83.         result looks something like this:
  84.  
  85.         File Name     Size    Date      Description                   Dir
  86.         -----------------------------------------------------------------
  87.         FILE1.FIL     10000  12-20-89   File Number 1                 TXT
  88.         FILE2.FIL     10000  12-20-89  *File Number 2                 TXT
  89.  
  90.         In this example,  FMSARC found FILE1.FIL on the drive and did NOT
  91.         find  FILE2.FIL.   Note that the asterisk appears just before the
  92.         description.   When  the  user  has selected  color  for  display
  93.         preference, the asterisk stands out in the same color as the file
  94.         date.
  95.  
  96.         This  lets  users  know  immediately  what  files  are  available
  97.         immediately  and what files need to be requested from the  SysOp.
  98.         I  wrote this to automate the process and save a bunch  of  time.
  99.         FMSARC  also creates a file summarizing the changes  made.   This
  100.         file  can  be used as a bulletin or as a list of files backed  up
  101.         off the drive.
  102.  
  103.         It  will work with all FMS directory line  lengths.   It  doesn't
  104.         care  whether you have 40 character descriptions or 44  character
  105.         descriptions.   It will not alter any part of the directory other
  106.         than  position  33  of  each  line that  contains  a  file  name.
  107.         Extended descriptions are untouched.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                         2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.         FMSARC V1.30 Copyright 1990 by Michael Walsh          Page 3
  134.  
  135.  
  136.         INSTALLATION/PREPARATION
  137.         -----------------------------------------------------------------
  138.  
  139.         Installing and using FMSARC is easy.  You can even run it as part
  140.         of  your  daily  or weekly  maintenance,  automating  the  ENTIRE
  141.         process if you like.
  142.  
  143.         First, you need to get a list of the directories all of the files
  144.         are stored in.   Then,  using the DOS command SUBST, substitute a
  145.         drive spec for each directory.   You will probably need to put  a
  146.         line in your CONFIG.SYS file of the form:
  147.              LASTDRIVE = d:
  148.         where d: is the highest drive spec you are using.
  149.  
  150.         That done, running FMSARC is a snap.  The syntax is:
  151.  
  152.         FMSARC <fms directory name> <drives to search> [-C<changes file>]
  153.                [-N] [-T<Title>]
  154.         where:
  155.            <fms directory name> is the file containing the FMS directory
  156.            <drives to search> is the list of substituted drives
  157.         and optionally:
  158.            [-C<changes file>] is the file to write the changes summary to
  159.            [-N] to write a file containing files not in the FMS but found
  160.            [-T] to change the title of the Changes bulletin
  161.  
  162.         EXAMPLE:
  163.  
  164.         To  check  an FMS directory named FMS.DIR against  the  files  on
  165.         drives C:,  D:,  E: and F: and write the changes to a file called
  166.         BULLET7 on drive B: with the title "MAIN FILE AREA", the  command
  167.         would be:
  168.  
  169.              FMSARC FMS.DIR CDEF -CB:BULLET7 -TMAIN FILE AREA
  170.  
  171.         Note  that there are no spaces in the drive specs.   Do not use a
  172.         space between the -C switch and the pathname for the changes file
  173.         or the -T switch and the title.
  174.  
  175.         FMSARC will then read the directories of the drives you selected,
  176.         read  and correct the FMS directory based on the files  it  could
  177.         find,  and  then  write the corrected FMS directory  and  changes
  178.         summary files.
  179.  
  180.         Since  no  user input is needed,  it can be run as part of  daily
  181.         maintenance on the board if you like.   The summary file argument
  182.         can take a full pathname, and defaults to FMSARC.CHG if omitted.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                         3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.         FMSARC V1.30 Copyright 1990 by Michael Walsh          Page 4
  200.  
  201.  
  202.         A SCREED ON FREEWARE
  203.         -----------------------------------------------------------------
  204.  
  205.         I  am  a firm believer that SysOps who make no money  from  their
  206.         BBS's  should not have to pay someone hard earned money in  order
  207.         to  make  their lives a little easier.   Therefore,  all  of  the
  208.         programs and utilities I release are released free of charge  and
  209.         the expectations of monetary gain.
  210.  
  211.         All  too  often I run into a good piece of software that I  would
  212.         love to run on my BBS (mostly DOORS,  but could be anything)  but
  213.         the  author demands money to get a "registered version" that  has
  214.         full  functionality.   In other words,  pay me so that I can make
  215.         more money while you just pay.   ARRRGGGHHH!   Are there no other
  216.         SysOps out there that feel as I do?   I had hoped that the spirit
  217.         of  RBBS (completely FREE of "registration") would have  pervaded
  218.         the community, but alas, there are too few of us out there.
  219.  
  220.         None the less,  I will continue to buck the trend.   I just  hope
  221.         that  one day we can all get together and help each other out  to
  222.         make  the  BBS community a better place WITHOUT the  profiteering
  223.         that pervades it now.
  224.  
  225.         If you have any comments or suggestions for improvements that can
  226.         be made to FMSARC, please contact me at my BBS or via Compuserve.
  227.         I will answer all mail and endeavor to make this utility one that
  228.         we can ALL enjoy.
  229.  
  230.         ---Michael Walsh
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                         4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.